home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / systems / mac / cmactex / Readme.Installation < prev    next >
Text File  |  1994-08-25  |  5KB  |  85 lines
  1. Installation of CMacTeX2.2
  2.  
  3. The installation of CMacTeX2.2 is not that difficult.  All of the files 
  4. have been compacted with Compact Pro, written by Bill Goodman.
  5. They will unpack to 7 megabytes automatically when they are opened.  
  6. (If Gatekeeper or some other Virus checker is installed on your Macintosh, 
  7. disable it before unpacking the files. 
  8. After you have downloaded the files you want, run them through
  9. any program that utilizes BinHex4.0 in order to convert the .hqx files.
  10. Unpack the files and place them anywhere on your hard drive. In order
  11. to help users who are not familiar with TeX I will explain the setup I use.
  12.  
  13. My hard disk drive is called "Apollo" and I created a folder to contain all
  14. of the TeX files. I named this folder "TeX Folder." Inside this folder I placed
  15. all of the applications in CMacTeX: smallinitex, biginitex, smalltex, bigtex,
  16. smallinimf, biginimf, smallmf, bigmf, dvips, dvipreview, and PrintPS.
  17. All of the utility programs (afm2tfm, gftopk, pktogf, etc.) were put in
  18. a subfolder of the main tex folder called "Utilities."  All of the support files
  19. for TeX were placed in six subfolders of the main tex folder, namely
  20. "texfonts", "texformats", "texinputs", "mfinputs", "mfbases", and "ps".
  21. Each of these subfolders contain very different types of files.
  22.  
  23. The "texfonts" folder contains all of the font files needed by any of the 
  24. programs. The TeX font metric (.tfm) files are placed in a subfolder of
  25. "texfonts" called "tfms". The Postscript font metric files are placed in
  26. a separate subfolder of "texfonts" called "PStfms". All of the pk files are
  27. placed in another subfolder of "texfonts" called "pks". Finally the Postscript
  28. virtual font files (.vf) are placed in yet another subfolder of "texfonts" called
  29. "PSvfs". Hence the "texfonts" folder contains four subfolders and all font files
  30. are distributed among these subfolders by type.
  31.  
  32. The "texformats" subfolder of the main tex folder contains the file "tex.pool"
  33. and all format files (.fmt) created by initex.
  34.  
  35. The "texinputs" subfolder contains all the macro (.tex, .sty, etc.) files needed
  36. by TeX. 
  37.  
  38. The "mfinputs" subfolder contains all the .mf files Metafont needs to build
  39. .tfm and .pk files. Any file with a .mf extension should be in this folder.
  40.  
  41. The "mfbases" subfolder contains the file "mf.pool" and all base (.base) files
  42. created by inimf.
  43.  
  44. Finally, the "ps" subfolder contains the config and .pro files needed by dvips.
  45.  
  46. All of these folders may be renamed, split up, or recombined in any
  47. fashion.  The only restriction in naming these files and folders is 
  48. that no file or folder name may contain either a slash ('/'), a 
  49. colon (':'), or an asterisk(*).    
  50.  
  51. After you have decided where to place all these files you must edit three files:
  52. "texmf.env", "dvips.env", and "dvipreview.env."
  53. These are ordinary ascii files and can be edited with any word
  54. processor, including TeachText.  These files contain the definitions
  55. of the environment variables used by the programs in CMacTeX2.2.
  56. These environment variables define the paths that all the programs
  57. will use to locate tfm files, macros, formats, pk files, etc.  The 
  58. paths must be defined with care and follow the format given in
  59. the files themselves.  Dvips and TeX use different conventions for
  60. indicating subdirectory searching and for this reason there are two
  61. files defining the paths. The file "dvips.env" is used by dvips, dvipreview.env
  62. by dvipreview, while all of the remaining programs read "texmf.env."
  63. This results in some duplication between the two files. If later you
  64. move some files, you will have to edit these files to reflect your
  65. changes.  After you have set these environment variables, place them
  66. in the Preferences folder inside your System Folder.
  67. If you copied my setup above, all you should have to do to edit these
  68. files is replaced the word "Apollo" with the name of your hard disk 
  69. drive.  All of the .env files contain other entries you can use to set
  70. specific features of the programs.
  71.  
  72. In addition to ".env" files, there is a third file, "tex.config" which also 
  73. should be placed in your Preferences folder inside your System Folder.  
  74.  
  75. This is a simple resource file used by the various programs of CMacTeX2.2
  76. to communicate with each other.  There is nothing in this file that
  77. you should change manually.  When TeX produces a dvi file, this file
  78. is recorded in "tex.config."  When dvips or dvipreview is opened, this
  79. file will appear under the File menu.  You can simply select it for
  80. further processing without having to go through a file dialog to locate
  81. it.  The same type of communication also occurs between dvips and
  82. PrintPS.  Also "tex.config" records the current tex format, so that
  83. it will be automatically selected the next time TeX is opened.
  84.  
  85.